Vibe Coding 的新手體驗 - Claude Code on Desktop
TLDR
- Claude Code on Desktop 透過
.claude-worktrees建立隔離環境，確保原始專案安全。 - 專案上下文（Context）讀取能力遠勝傳統對話式 AI，能有效避免程式碼生成截斷問題。
- 需注意「每週運算時數限制」，避免因過度消耗 Token 而被鎖定。
- Session 中斷後無法自動恢復，建議採用
CLAUDE.md進行規範管理。 - 建議採用分層配置：全域設定 (
~/.claude/CLAUDE.md)、專案設定 (.claude/CLAUDE.md) 與模組化規則 (.claude/rules/*.md)。 - 避免讓 AI 自動執行複雜的 Git 操作（如
rebase），建議手動介入或提供明確的 Commit Hash。 - 應採取「多模型協作」策略，根據任務複雜度與成本分配不同 AI 模型。
Claude Code on Desktop 運作機制
Claude Code on Desktop 透過隔離機制保護原始專案。當選擇一個 Repository 後，系統會在使用者資料夾下的 .claude-worktrees 目錄中建立專案副本，並產生隨機名稱的子資料夾與 Git 分支。所有修改均發生在此隔離環境中，確保原始程式碼不受影響，並支援多任務並行處理。
核心體驗：上下文理解與情緒價值
與傳統對話式 AI 相比，Claude Code 的優勢在於能完整讀取並理解整個專案結構。這解決了以往因輸入限制導致的程式碼截斷問題，且在複雜邏輯處理上更為精準。此外，AI 在協作過程中能提供良好的情緒價值，對於優化建議與程式碼解釋具有正面助益。
遇到的問題與技術地雷
1. 對話工作階段 (Session) 無法延續
- 發生情境：操作中斷或閒置過久。
- 問題描述：系統會出現 401 Unauthorized 錯誤，且無法恢復舊 Session，開啟新 Session 會導致 Context 歸零。
- 建議做法：需透過特定非正規解法恢復，或在
CLAUDE.md中明確定義專案規範以利重建上下文。
2. 上下文理解的邏輯矛盾
- 發生情境：引用外部 Markdown 檔案作為規範時。
- 問題描述：AI 對於「何時讀取規範」的說法前後不一（載入時 vs. 寫 Commit 時），且無法自動解析連結中的檔案內容。
- 建議做法：採用分層配置管理，並將規範內容直接寫入
CLAUDE.md或其子規則檔案中，確保 AI 能 100% 讀取。
3. Git 操作的風險
- 發生情境：請 AI 自動執行 Git 指令時。
- 問題描述：AI 可能會繞遠路執行複雜操作（如
rebase），導致 Git 線圖混亂；且其快照機制可能在手動修正衝突後，以舊快照覆蓋異動。 - 建議做法：若必須請 AI 操作 Git，請務必提供具體的 Commit Hash，避免模糊指令。
4. 效能延遲 (Lag)
- 發生情境：介面操作反應緩慢時。
- 問題描述：因介面延遲導致重複發送指令，造成操作混亂並額外消耗運算額度。
- 建議做法：操作時應耐心等待回應，避免連續點擊。
CLAUDE.md 配置最佳實務
為了確保 AI 能精準套用規範，建議採用以下分層管理方式：
- 全域設定：
~/.claude/CLAUDE.md，適用於所有 Session。 - 專案設定：
.claude/CLAUDE.md，專案專用的主要設定。 - 模組化規則：
.claude/rules/*.md，將 Git、Vue 等規範拆分，依需求讀取。 - 本地覆寫：
./CLAUDE.local.md，專案專用的本地規則，需加入.gitignore。 - 局部上下文：在特定子目錄（如
backend/）放置CLAUDE.md，Agent 處理該目錄檔案時會自動套用。
結語：多模型協作策略
開發者應根據任務性質分配 AI 工具，以達到成本與效率的最佳平衡：
- 深度專案開發：使用 Claude Code。
- 一般技術諮詢：使用 Gemini 或其他模型。
- 簡單任務（如 Commit Message）：使用免費或低成本模型。
- 複雜 Git 操作：建議由開發者手動執行，確保版本控制安全。
異動歷程
- 初版文件建立。
- 補充公佈的官方 CLAUDE.md 配置最佳實務與上下文繼承機制說明。